home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2004 #9 / Amiga Plus CD - 2004 - No. 09.iso / amigaplus / tools / mos_pegasos / kme_v1.3 / kme.readme < prev    next >
Text File  |  2004-08-03  |  5KB  |  161 lines
  1.  
  2.  
  3.                                   KME  V1.3
  4.                              by Christian Stiens
  5.                                and Wishmaster
  6.                                  User Manual
  7.  
  8.  
  9. Introduction
  10.  
  11. KME stands for "KeyMapEditor". It is a program with that you can edit the
  12. keymaps stored in DEVS:keymaps, which you can load with the "Setmap" command
  13. on Amiga or on the Pegasos under System-Settings/Input.
  14.  
  15.  
  16. Copyright
  17.  
  18.  
  19. V1.0, 01-Jul-91: first release
  20. V1.1, 28-Oct-91: message filtering, ...
  21. V1.2, 26-Mar-92: 2.0-BusyPointer, ..., Iconify by Steffen Köhler
  22.  
  23. © Copyright 1992 by   Christian Stiens
  24.                       Heustiege 2
  25.                       W-4710 Lüdinghausen
  26.                       GERMANY
  27.  
  28.  
  29. V1.3, 04-Jul-2004: Updates by Wishmaster <tonyiommi@gmx.net>
  30.     · Keyboardlayout reworked for PC105 Keyboards
  31.     · Storation of Preferences added
  32.     · Rememberation of Windowpositions added
  33.     · Tooltypes added
  34.         KEYBOARD=PC105/PC104/AMIGA
  35.         STOREONEXIT
  36.     · ASL-Filerequesters
  37.     · Gadgets reworked (bare bones Intuition GUI)
  38.     · completed/reworked italian Keymap done by Fulvio Peruggi added
  39.  
  40. © 2004 Wishmaster <tonyiommi@gmx.net>
  41.  
  42.  
  43. Usage of this program is at your own risk. There is no liability or
  44. responsibility for any damage caused by this program.
  45.  
  46. All Rights Reserved.
  47.  
  48.  
  49. Requirements
  50.  
  51. KME was testet under MorphOS 1.4.2.
  52.  
  53.  
  54. Manual
  55.  
  56. KME can be started via Workbench or CLI.
  57.  
  58. In the upper half of the KME window you see the keyboard. You can select
  59. a key by clicking on it with your mouse or by pressing the key on your
  60. keyboard.
  61.  
  62. On the right hand side of the window you find 8 string gadgets. They contain
  63. the strings which the actual key sends when he is pressed together with the
  64. corresponding qualifiers indicated on the left side of the gadgets.
  65.  
  66. The AOS 2.0 tabCycle feature is supported. So you can move to the next
  67. gadget by pressing the tab key and go to the previous by pressing shift-tab.
  68.  
  69. You can put in special control codes by preceding them a backslash:
  70.  
  71.     \n      Line-feed         ($0A)
  72.     \t      Tabulator         ($09)
  73.     \f      Form-feed         ($0C)
  74.     \r      Carriage-return   ($0D)
  75.     \b      Backspace         ($08)
  76.     \e      Escape            ($1B)
  77.     \[      CSI               ($9B)
  78.     \\      the backslash     ("\")
  79.     \xHH    the char with ascii code $HH
  80.  
  81. On the left side you see 5 rows with boolean gadgets which I now describe:
  82.  
  83. The action gadgets:
  84.  
  85.   LOAD:
  86.     The filerequester appears and you can select a keymap you want to modify.
  87.     Be sure not to load other executables than keymaps. KME can't check
  88.     if the file is a keymap, because there is no id in keymaps like in fonts.
  89.     The machine could crash if you load a executable that's not a keymap,
  90.     but I haven't tried.
  91.  
  92.   SAVE:
  93.     Again the filerequester appears and you can select a name for your
  94.     modified keymap to be saved.
  95.  
  96.   ABOUT:
  97.     Shows the information requester.
  98.  
  99.   QUIT:
  100.     Lets you quit the program after safety requester.
  101.  
  102.   ICONIFY:
  103.     Press this button if you want to leave KME for a while. The KME window
  104.     is reactivated by double clicking the icon.
  105.  
  106.   UNDO:
  107.     This takes back the changes that you have done with the actual key.
  108.  
  109.  
  110. The parameter gadgets:
  111.  
  112.   SHIFT, ALT, CONTROL:
  113.     This flags defines, which qualifiers are valid for the actual key.
  114.     There is a specialty for vanilla keys (keys with SHIFT, ALT, CONTROL
  115.     flag set, but DEAD and STRING flag unset):
  116.     The control-code for this kind of keys is made by clearing bits 5 and 6
  117.     of the char.
  118.  
  119.   DOWNUP:
  120.     Maybe this flag will work under Kickstart 3.0 ?!?  :-)
  121.  
  122.   DEAD:
  123.     If your key is a deadkey then you must set this flag. On the right
  124.     side of the string gadgets you can see 8 little gadgets. By clicking
  125.     on those gadgets you cycle through the 3 states "DEAD", "MOD" and none.
  126.     IF "DEAD" is set, then the string gadget contains the dead key code
  127.     i.e. an offset to the deadkey table. IF "MOD" is set, then the string
  128.     gadget holds the deadkey table, i.e. a field with 6 characters.
  129.     For the character "a" e.g. the deadkey table looks like "aáàâãä".
  130.     Only the german keymap uses an 18 char long deadkey table, therefore
  131.     the german keymap can work with double deadkeys, that means by pressing
  132.     <apostoph> <shift-apostroph> <o> you get "ô".
  133.  
  134.   STRING:
  135.     The actual key can send a string instead of only one char, if this
  136.     flag is set.
  137.  
  138.   NOP:
  139.     If this flag is set, no character is send when the key is pressed.
  140.  
  141.   CAPSABLE:
  142.     Keys with this flag set are capsable. That means they can be shifted
  143.     be the caps lock key.
  144.  
  145.   REPEATABLE:
  146.     This flag defines, wether the key repeat function is enabled for
  147.     the key.
  148.  
  149.  
  150. Note
  151.  
  152. If you want to load in the modified keymap with "SetMap", you must keep in
  153. mind, that "SetMap" wont load the map if there is a map with same name
  154. in memory.
  155.  
  156.  
  157. Much fun!
  158.  
  159. --- Chris
  160.  
  161.